home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 41 / Amiga Format CD41 (1999-06)(Future Publishing)(GB)[!][issue 1999-07].iso / -seriously_amiga- / misc / verscheck / doku / readme.english < prev    next >
Text File  |  1999-04-19  |  8KB  |  220 lines
  1. VersCheck
  2. =========
  3.  
  4. The program VersCheck is freeware.
  5.  
  6.  
  7. LEGAL:
  8. ======
  9. All copyright's reserved by Michaela Pruess.
  10. You have only permission for non-commercial use of this tool.
  11. The Aminet has permission to publish this file on all
  12. Aminet-sites, Aminet-mirror's and Aminet-CD's.
  13.  
  14. This software is provided as-is, without warranty of any kind,
  15. either expressed or implied. In no event will the authoress be
  16. liable for direct, indirect, incidental or consequential damages
  17. or data loss resulting from the use or application of this software.
  18. The entire risk as to the results and performance of this software
  19. is assumed by the user. Furthermore, the contents of the archive
  20. cannot be altered in any way, although the archive itself can be
  21. transmitted electronically via BBS systems or the Internet.
  22.  
  23.  
  24.  
  25. Important!
  26. ----------
  27. This program use lot of stack. If the stack is to small, a GURU
  28. is the answer (or not, with thank's to MCP).
  29. The stackusage is variable, for big directorytree's more stack
  30. will need as for small trees.
  31. I think, 10000 upto 20000 is enough.
  32.  
  33.  
  34.  
  35. Copyright
  36. ---------
  37. The program is copyright by
  38.  
  39. Michaela Pruess
  40. Berlin
  41.  
  42. eMail: Michaela@Flagranti.net
  43.  
  44. Support, actual versions, other projects:
  45. -----------------------------------------
  46. WWW:   http://www.flagranti.net/amiga
  47.  
  48.  
  49.  
  50. The program is written in C with vbcc 0.7.
  51. You will find the latest version of this and other project from me
  52. on me homepage.
  53.  
  54.  
  55. Install:
  56. --------
  57. Copy the program in any directory you like.
  58.  
  59. To use the comparesystem:
  60. Go in the directory that include the path "scripts" with the
  61. comparelists and start the program from this directory.
  62.  
  63. Use as versionlister/-checker:
  64. You can put the program to any location and start it from
  65. all positions you like.
  66. Read the manual ReadMe.locale to use language-texts.
  67.  
  68.  
  69. Third party products:
  70. ---------------------
  71. VersCheck uses some third party producs:
  72.  
  73. 1.) Command VERSION from AmigaDOS. BE CAREFULLY with the
  74.     "better replacements". They often read only the $VER-
  75.     string, the original read much more.
  76.  
  77. 2.) ppc.library (if exists) to find informations about
  78.     installed PowerPC-CPU(s) and info's about them.
  79.     Original by Phase5.
  80.     (Emulation by Frank Wille *not testet* yet).
  81.  
  82. 3.) mmu.library V0.24+ (is exists) to find informations about
  83.     MMUs.
  84.     Original by Thor, see AmiNet
  85.     PPC-User read 'Known errors', please.
  86.  
  87. 4.) reqtools.library for requesters.
  88.     Copyright by © Nico François and Magnus Holmgren.
  89.  
  90. If a library not exist, the check will skipped and no info's
  91. printed. If a library can not work (mmu.library) the info's
  92. also skipped.
  93. If there is no version-command it can't be used for
  94. compare/information. This will reduce the change to identify
  95. and/or find versioninformations.
  96.  
  97.  
  98.  
  99. Programfunctions and background
  100. -------------------------------
  101. The program searches "$VER:"-string and split them. It also run the
  102. command 'version' and split the output, too.
  103.  
  104. The program do not sort. It scan's the filesystem and compare
  105. direct all entries (function ExAll() is used!). No sort make it
  106. faster, except systems with many files.
  107.  
  108. The outputdata is useable for many things. But in first order it
  109. will be used to compare it with the Lib-, DT- and Device-check.
  110.  
  111. I found the idea behind the checksystms very good and I see the
  112. time and energy for catalog and support this lists.
  113.  
  114. But there is a problem, with is very komplex and it is very difficult
  115. to correct by cli-scripts, ARexx or other batchbased systems.
  116. Most problem will be found by older libs. Versionnumbers like
  117. "1.-1", wrong or funny strings at the position of the name and
  118. versionnumbers that called x.x, V x.x or Vx.x!
  119.  
  120. This program "tried" to identify this data and compare the result with the
  121. comparedata. "Tried" while I only can test and check the data with my
  122. system. So the identifying will not be perfect in the first version
  123. but this will be better from version to version.
  124.  
  125. If the output really shit (sorry), please send me a copy of the files
  126. that produce the wrong output. Please contact me first, if the files
  127. are not freely distribtable. In this case it is better send me a cut
  128. from the file. Otherwise the copy is piratesoft and I don't will become
  129. such software.
  130.  
  131.  
  132. Future
  133. ------
  134. Better compare, errorcorrection and new functions. If you wish a special
  135. function for any useage, let it me know.
  136.  
  137. The program DVC, that do parts of this tests in the past, includes
  138. functions that I never will missing. E.g. testing of files for there
  139. version. A requester ask for install the file. The problem is, DVC is
  140. not longer 100% actual. And I missing functions like installing new
  141. file automaticly (by backup the actual files). I also missing a switch
  142. that skip older files by default. So I will create a copyfunction
  143. like DVC with more and better features.
  144.  
  145. To identify files only by extensions is also a problem from DVC. A
  146. readme, named xxx.library, will be copied to libs:, not lly usefull.
  147.  
  148. More datatypes should be identified.
  149.  
  150.  
  151. Known Bugs
  152. ----------
  153. The actual mmu.library will not work on PPC-systems and so on such
  154. systems the MMU can't be displayed.
  155. The author has no information about the mmu-useage on ppc-systems
  156. and Phase-5 don't cooperate. Because the help of Haage & Partner
  157. this problem is only temporary.
  158.  
  159.  
  160. Problem with other programs
  161. ---------------------------
  162. At my tests the system stops at bigger directory's. Reasons:
  163.  
  164. 1.) Output in a KingCon-CLI-window (CON: and AUX: remapped to KingCon).
  165.     Reason unknown, bit same problem appears by use of vim and other
  166.     programs. A long time this problem don't exist, then it comes up.
  167.     I think it is a problem between KingCon und another unknown software.
  168.     To do: Using verbose-mode (-v) fix the problem (I don't know why)
  169.  
  170. 2.) System full stops at testing mpegavideo.datatype.
  171.     Reason is the command c:version. I don't know why, but the command
  172.     crashes. I'm not shure, but I think it is a hardwareproblem at my
  173.     system.
  174.     To do: The problem will not appear if the directory that will be tested
  175.            is into a Ram-disk (Rad-disk).
  176.     After installation of WarpOS and decrunching all files on Sys: the
  177.     check works. I'm not shure why. But I think decrunching the files
  178.     is the right way. WHY ANYBODY CRUNCHING ANYTHING? The prices of
  179.     harddisk are low and crunched files are slow.
  180.  
  181.  
  182. ------------------------------------------------------------------------
  183. --- Attachment for compare with LibGuide, DTypesGuide und DevsGuide: ---
  184. ------------------------------------------------------------------------
  185.  
  186. The compare:
  187. ------------
  188. Any file is identified by the "magic number". The "magic number"
  189. are the first 4 bytes (evetually 8, but I this case 4 are enough)
  190. of a binary file. On this a file can be identified, e.g. an
  191. Amigaprogram, a MS-Dos-Program and so on.! Libraries, devices and
  192. datatypes have all the code for 'executable amigaprogram'. So only
  193. files with this 'magic number' are tested in the moment.
  194. So a textfile, called "Libs:Irgendwas.Library" will not be tested!
  195. The filetypes ELF/EHF (PowerUP/WarpOS) from ppc can only be checked
  196. by using the '-x'-option.
  197.  
  198. The extensions ".library", ".device" oder ".datatype" will be also
  199. tested. If nessesary this will be expanded. (e.g. MUI 'mcc' and
  200. 'mcp'). If the checkguides will test more things I will change this
  201. for them.
  202.  
  203. For the header the mmu.library and the ppc.library will be used.
  204. If they are not installed, the part will be ignored.
  205.  
  206. The versioncompare will done numeric, the version is splitt into
  207. th 2 or 3 parts from X.Y(.Z). The numeric values will be corrected.
  208. Versions like 1.-1 gives Version 1, Revision 1.
  209.  
  210.  
  211. ToDo:
  212. -----
  213. - Caracters between name and version add to name.
  214.   I found two or three libraries that will need this.
  215.  
  216. - Alternative search for versionnumber [search '(DATUM)'] for
  217.   very bad programmed things. I know only one file.
  218.  
  219. - Identify versionstrash like "%ld" etc.! Only one file known.
  220.